3D Graphics Programming with QuickDraw 3D 1.5.4

Badges

The 3D Viewer allows your application to distinguish 3D data from static graphics in documents by the use of a badge. Figure 8 shows a viewer pane with a badge.

Figure 8 A 3D model with a badge

The badge lets the user know that the image represents a 3D model rather than a static image. A badge appears when the viewer object is first displayed and the kQ3ViewerShowBadge flag is set in the object's viewer flags. When the user clicks the badge, the badge disappears and the standard controller strip appears.

The badge control in unidirectional: it switches only from badge mode to controller strip mode. There is currently no user interface control to switch the viewer back to badge mode. If you want to switch from controller strip mode to badge mode (for instance, when a viewer object is deselected in a compound document), you must reset the viewer's flags and clear the controller strip.

Your application can control whether the 3D Viewer displays a badge in a viewer pane by appropriately setting a viewer's flags. See "Viewer Flags" for more information. Typically you won't want a viewer pane to support user interaction when the badge is displayed. To disable interaction, you must set the viewer to drag mode using the kQ3ViewerDragMode flag.